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(54) Method and apparatus for implementing deployment descriptions in an enterprise 
environment 



(57) Methods and apparatus for implementing 
deployment descriptors which are used to deploy mod- 
ules in an enterprise environment are disclosed. 
According to one aspect of the present invention, a 
method for deploying an application using a deployment 
too] for use on a platform server includes creating the 
application, creating an application deployment descrip- 
tor for the application, packaging the application in an 
archive, and deploying the application packaged in the 
archive. Creating the application includes obtaining an 
application component which has an associated appli- 
cation component deployment descriptor that has infor- 
mation relating to the deployment of the application 
component. The application deployment descriptor for 
the application includes information arranged to identify 
the application component, and packaging the applica- 
tion in an archive includes packaging the application 
component, the application component deployment 
descriptor, and the application deployment descriptor. 
The application packaged in the archive is deployed 
using the application component deployment descriptor. 
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Description 

BACKGROUND OF THE INVENTION 

1 . Field of the Invention 5 

[0001] The present invention relates generally to 
enterprise information systems. More particularly, the 
present invention relates to the use of deployment 
descriptors in modules packaged for use in enterprise* io 
based applications. 

2. Description of the Related Art 

[0002] As the use of enterprise environments is 15 
increasing, it becomes necessary to increase the over- 
all efficiency with which the enterprise environments 
may be used. Increasing the efficiency typically includes 
reducing the costs of implementing enterprises and low- 
ering response times associated with enterprises. 20 
[0003] Enterprise information systems are typically 
part of an enterprise, and provide services to users of 
an enterprise. When new services are to be provided to 
users, the new services generally must he integrated 
with the enterprise infomiation systems. Figure 1 is a 25 
diagrammatic representation of a composition model for 
an enterprise application. An enterprise application 112 
includes an enterprise information system 104 and new 
services 108. Application 112 is arranged to be 
deployed by a deployer 1 1 6 such that a deployed appli- 30 
cation 112 may be used on a platfomri 120. 
[0004] Typically, in order to enable new services 
1 08 to be offered to a user along with enterprise Infor- 
mation system 104, new services 108 must be inte- 
grated with enterprise information system 104 within 35 
application 112. In order to integrate new services 108 
with enterprise information system 1 04, a developer is 
responsible for coding specific interactions between 
new services 108 and enterprise information system 
1 04. In other words, modifications are generally made 40 
to new services 1 08 and enterprise information system 
104 such that new services 108 may be offered along 
with services included in enterprise information system 
104. 

[0005] The need to code interactions, such as 45 
transaction management interactions and security man- 
agement interactions, may be inefficient since each time 
a new service is to be offered to a user, a developer 
must code interactions with the new service. Coding 
interactions generally does not enable new services to so 
be rapidly deployed. In addition, the need to code inter- 
actions often places a burden on a developer to learn 
how different services interact. 
[0006] Therefore, what is desired is an enterprise 
system which allows new services to be efficiently 55 
deployed. In other words, what is needed is a system 
which eliminates the need for a developer to code spe- 
cific interactions between services of the system. 



SUMI\4ARY OF THE INVENTION 

[0007] The present invention relates to deployment 
descriptors which are used to deploy modules in an 
enterprise environment. According to one aspect of the 
present invention, a method for deploying an application 
using a deployment tool for use on a platfomn server 
includes creating the application, creating an applica- 
tion deployment descriptor for the application, packag- 
ing the application in an archive, and deploying the 
application packaged in the archive. Creating the appli- 
cation includes obtaining an application component 
which has an associated application component deploy- 
ment descriptor that has information relating to the 
deployment of the application component. The applica- 
tion deployment descriptor for the application includes 
information arranged to identify the application compo- 
nent, and packaging the application in an archive 
includes packaging the application component, the 
application component deployment descriptor, and the 
application deployment descriptor. The application 
packaged in the archive is deployed using the applica- 
tion component deployment descriptor. 
[0008] In one embodiment, creating the application 
further includes obtaining a second application compo- 
nent having an associated application component 
deployment descriptor. In such an embodiment, the 
application deployment descriptor includes information 
anBnged to identify the second application component, 
and the archive further includes the second application 
component and the appifcation component descriptor 
associated with the second application component. 
[0009] These and other advantages of the present 
invention will become apparent upon reading the follow- 
ing detailed descriptions and studying the various fig- 
ures of tiie drawings. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0010] The present invention may best be under- 
stood by reference to the following description taken in 
conjunction with the accompanying drawings in which: 

Rgure 1 is a diagrammatic representation of a com- 
position model for an enterprise application. 
Rgure 2 is a diagrammatic representation of a com- 
position model for modules with deployment 
descriptors In accordance with an embodiment of 
the present invention. 

Rgure 3 Is a process flow diagram which illustrates 
the steps associated with creating and deploying an 
application which incorporates deployment descrip- 
tors in accordance with an embodiment of the 

present invention. 

Rgure 4 is a process flow diagram which illustrates 
the steps associated with assembling an applica- 
tion which incorporates deployment descriptors. 
Le., step 312 of Figure 3, in accordance with an 
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embodiment of the present invention. 
Figure 5a is a process flow diagram which illus- 
trates the steps associated with deploying a stand- 
alone module with a deployment descriptor in 
accordance with an embodiment of the present s 
invention. 

Figure 5b is a process flow diagram which illus- 
trates the steps associated with deploying an appli- 
cation which incorporates deployment descriptors, 
/.e., an application as packaged in step 420 of Rg- io 
ure 4, in accordance with an embodiment of the 
present invention. 

Rgure 6 is a diagrammatic representation of an 
application deployment descriptor in accordance 
with an embodiment of the present invention. is 
Figure 7 is a diagrammatic representation of an 
Enterprise Java Bean (EJB) module deployment 
descriptor in accordance with an embodiment of 
the present invention. 

Figure 8 is a diagrammatic representation of a web 20 
client module deployment descriptor In accordance 
with an embodiment of the present invention. 
Figure 9 is a diagrammatic representation of an 
application client module deployment descriptor in 
accordance with an embodiment of the present 25 
invention. 

Figure 10 is a diagrammatic representation of a 
computer system suitable for implementing the 
present invention. 

30 

DETAILED DESCRIPTION OF THE EMBODIMENTS 

[0011] When applications are created such tat serv- 
ices, e.g.. transaction management services and secu- 
rity management services, are offered to a user, 35 
interactions between various services are coded by a 
developer to enable the services to be offered together 
The need to code interactions between services may be 
inefficient since each time a new service is to be offered 
to a user, a developer must code interactions between 40 
existing services and the new service, 
[0012] Implementing a data structure, e.g., a 
deployment descriptor, within each new service, e.g., 
module, that describes how the new service may be 
integrated with other services allows different services 45 
to be readily "fit" together. When a module is created to 
include a deployment descriptor, the need for a devel- 
oper to code interactions between modules is effectively 
eliminated. The interaction of a given module with other 
modules is essentially described in the deployment so 
descriptor of the given module. The use of deployment 
descriptors also enables a deployer to read a deploy- 
ment descriptor associated with a module, and deter- 
mine how to deploy the module as a part of an 
application or alone. 55 
[0013] In general, applications which incorporate 
deployment descriptors include one or more compo- 
nents and an application deployment descriptor. Within 



the application deployment descriptor, components are 
generally listed, or othenwise grouped, as modules. 
Specifically, modules include one or more components 
of the same type, as well as a component level deploy- 
ment descriptor. An application which incorporates 
deployment descriptors also facilitates the packaging 
and deployment of components as Individual compo- 
nents, component libraries, and parts of applications. 
For example, it is possible for a deployment tool to use 
the deployment descriptors to readily determine how to 
deploy components as stand-alone components. 
[0014] Figure 2 is a diagrammatic representation of 
a composition model for modules with deployment 
descriptors in accordance with an embodiment of the 
present invention. A composition model 200 includes 
components 208, modules 212, an application 216, a 
deployment tool 220, and a platform server 224. Com- 
ponents 208 essentially make up modules 212 which 
are used as "building blocks'* of application 21 6. Deploy- 
ment tool 220 is arranged to deploy application 21 6, or 
individual modules 212, such that they may be used on 
platform server 224. 

[0015] Components 208 are typically user-written, 
e.g., developer-written. Although component types may 
vary widely, they may include, but are not limited to, 
Enterprise Java Beans (EJBs) 208a and web applica- 
tions 208b. As will be appreciated by those skilled in the 
art, the EJB architecture is a component architecture for 
the development and deployment of component-based 
distributed business applications, and was developed 
by Sun Microsystems, Inc. of Palo Alto, California. 
[0016] EJBs 208a are grouped Into a user-written 
EJB module 212a, which includes an EJB module 
deployment descriptor 232. EJB module 212a may be 
included in application 216 or, alternatively, EJB module 
212a may be a stand-alone module which is deployed 
directly by deployment tool 220 without being assem- 
bled Into application 216. In the described embodiment, 
EJB module deployment descriptor 232 contains sub- 
stantially all declarative data which is necessary to 
deploy EJBs 208 using deployment tool 220. Addition- 
ally, EJB module deployment descriptor 232 may also 
include assembly instructions which describe how EJBs 
are composed into an application. EJB module deploy- 
ment descriptor 232 will be described below with refer- 
ence to Figure 7. 

[0017] Web applications 208b may be substantially 
anything which is suitable for inclusion as a part of the 
Worid Wide Web. In one embodiment, web applications 
208b may include servlets, or server-side programs 
written in the Java programming language developed at 
Sun Microsystems, Inc. of Palo Alto) California. Web 
applications 208b are grouped into a web client module 
212b, which includes a web client deployment descrip- 
tor 236 and is user-written. Web client deployment 
descriptor 236 will be discussed below with respect to 
Figure 8. 

[0018] Like EJB module 212a. web client module 
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212b may either be included in application 216 or 
deployed as a stand-alone module. Further, web client 
module 212b may also be deployed substantially 
directly by platfonn server 224, e.g., a web server. It 
should be appreciated that when web client module 
212b is deployed by a web server, the web server gen- 
erally includes deployment capabilities which are typi- 
cally included in deployment tool 220. 
[0019] Application client module 212c, which 
includes an application client deployment descriptor 
240 that will be discussed below with respect to Figure 
9, is often an application written in the Java program- 
ming language by a developer. Such an application gen- 
erally includes resource dependencies, but provides 
substantially no services, as will be understood by those 
skilled in the art. As was the case for EJB module 212a 
and web client module 212b, application client module 
212c may also be a stand-alone module which may be 
deployed directly by deployment tool 220. 
[0020] Application 216 is assembled by an assem- 
bler who also creates an application deployment 
descriptor 244. Application deployment descriptor 244 
contains a top level view of the contents of application 
216, and will be described below with reference to Fig- 
ure 6. In general, application 216 is packaged in an 
archive file format, and substantially only includes mod- 
ules 212 and application deployment descriptor 244. 
Within application 216, deployment descriptors 232, 
236, 240 may be isolated Into a target container 248 
such that deployment tool 220 may readily access 
deployment descriptors 232, 236, 240. 
[0021] As will be discussed below, application 216 
may be edited, e.g., modules may be added and 
deleted, as necessary for a variety of different reasons. 
By way of example, application 216 may be edited to 
resolve roles for deployment tool 220. Alternatively, 
application 216 may be edited by an assembler to unify 
declarations of security roles. Unifying declarations for 
security roles may involve resolving different names for 
a given role into a substantially "global" name for the 
given role. 

[0022] In some instances, editing application 216 
may result in the removal or elimination of a previously 
existent module that is needed, for example, by a web 
client module. When a previously existent module is 
eliminated from application 21 6, at the time of deploy- 
ment, a resolution must effectively be reached regard- 
ing the missing module. Specifically, when a needed 
module is not a part of application 216, that needed 
module essentially must be on, or accessible with 
respect to, platform server 224. 

[0023] Deployment tool 220 is associated with a ref- 
erence implementation 252, and is used by a deployer 
either to deploy application 216 or to deploy modules 
212 as stand-alone modules. Deployment tool 220 is 
generally an^nged to read deployment descriptors 232, 
236, 240, 244, and to deploy modules 212 according to 
the specifications and requirements of each module 



type. In addition, deployment tool 220 Installs applica- 
tion 216 onto a suitable platform, then configures and 
integrates application 216 into an existing infrastructure. 
Platform server 224 way be substantially any suitable 

5 application server. By way of example, suitable applica- 
tion servers may include, but are not limited to, EJB 
servers, desktops, and web servers. 
[0024] Referring next to Figure 3, the steps associ- 
ated creating and deploying an application will be 

10 described in accordance with an embodiment of the 
present Invention. A process 302 of creating and 
deploying an application begins at step 304 in which 
components are created by a component developer. In 
the described embodiment, the components are dis- 

15 Crete "Java 2 Enterprise Edition" (J2EE) components 
that are generally suitable for use on a J2EE platform 
developed by Sun Microsystems, Inc.. of Palo Alto, Cal- 
ifornia. It should be appreciated, however, that the com- 
ponents and the platfonn on which the components are 

20 intended for use may vary widely. 

[0025] Once components, which may be EJBs or 
any suitable web applications, for example, are created 
in step 304, modules axe created from the components 
in step 308. In addition, deployment descriptors associ- 

25 ated with the modules are also created in step 308. The 
deployment descriptor for each individual module 
includes substantially all declarative data which is 
needed to deploy components associated with the indi- 
vidual module in a Java archive (JAR) file format devel- 

30 oped by Sun Microsystems, Inc., of Palo Alto, California. 
e.g., the JAR which holds an overall application that 
Includes the individual module. 

[0026] Each module that is created typically 
includes one or more components of the same con- 
as tainer type, as well as a component deployment 
descriptor of that particular type. By way of example, for 
components which are web applications, the module 
created from the web applications may be a web client 
module, while the deployment descriptor may be a web 
40 client deployment descriptor. Although modules, e.g.. 
J2EE modules, are arranged to be 'building blocks" for 
an application, e.g., a J2EE application, the modules 
may also be deployed as a stand-alone module, as 
mentioned above with respect to Figure 2. 
45 [0027] After modules are created in step 308, tiien 
an overall application is assembled In step 312 from the 
various modules. An application typically includes one 
or more modules and an application deployment 
descriptor which effectively represents a top level view 
50 of the contents of an application. In one embodiment, 
when the application is a J2EE application, the applica- 
tion is packaged in a JAR file format. One process of 
assembling an overall application will be discussed 
below with reference to Figure 4. 
55 [0028] Once the application is assembled in step 
312, process flow may proceed to an optional step 316 
in which the assembled application is customized. As 
will be appreciated by those skilled in the art, it may be 



4 



7 



EP1 050 813 A2 



8 



desirable to customize an application before the appli- 
cation may be deployed into an enterprise. Customizing 
an application may include adding new modules, 
removing existing modules, and changing the content of 
modules. 

[0029] When the application is assembled, and 
optionally customized, then process flow moves to step 
320 where the application Is deployed, e.g., deployed by 
a deployment tool. During deployment, the application 
is installed on a suitable platform such as a J2EE plat- 
form. Once Installed, the application may be configured 
and integrated into an existing infrastructure. Each mod- 
ule which is a part of the application and, hence, is listed 
In the application deployment descriptor associated with 
the application, is deployed appropriately. That is. In one 
embodiment, each module listed in the application 
deployment descriptor is installed in a suitable con- 
tainer, and the declarative properties of each module 
are set to reflect the values declared by the deployment 
descriptor element for each component associated with 
each module. After the application is deployed, then the 
process of creating an deploying an application which 
incorporates deployment descriptors is completed. 
[0030] One method that is suitable for assembling 
an application will be described with reference to Figure 
4. Figure 4 is a process flow diagram which illustrates 
the steps associated with assembling an application 
which Incorporates deployment descriptors, /.e., step 
312 of Figure 3, in accordance with an embodiment of 
the present invention. A process 312 of assembling an 
application begins at step 404 in which substantially any 
modules tat Will be used to form the application are 
selected or otherwise identified, e,g,, by an application 
assembler. 

[0031] Once modules are selected, then a directory 
structure for the application is created in step 408. The 
directory structure for the application Is typically 
designed based upon the requirements of components 
within the selected modules. As a result, the steps asso- 
ciated with the creation of a directory structure may vary 
widely. In step 412, deployment parameters far the 
selected modules are reconciled. Reconciling deploy- 
ment parameters includes, but is not limited to, satisfy- 
ing dependencies and eliminating redundant security 
role names. In one embodiment, eliminating redundant 
security role names may Include creating a single name 
which replaces other names which identify essentially 
the same security role. That Is, unique security role 
names with redundant meanings may be renamed to a 
common name. 

[0032] After deployment parameters are reconciled, 
then a deployment descriptor for the application, i.e., an 
application deployment descriptor, Is created in step 
418. When the application Is a J2EE application, then 
the application deployment descriptor may be an XML 
deployment descriptor. In other words, for a J2EE appli- 
cation, the application deployment descriptor may be an 
XML document according to the document type defini- 



tion for a J2EE:application XML document. The applica- 
tion deployment descriptor, which will be described 
below with reference to Figure 6, is arranged to provide 
a listing of contents of the application, and to provide 
5 version links to deployment descriptors associated with 
modules. 

[0033] From step 416, process flow proceeds to 
step 420 In which the application Is packaged. Packag- 
ing an application may Include, but is not limited to, plac- 

10 ing modules and the application deployment descriptor 
into appropriate directories and packaging the directory 
structure In a JAR file using a JAR file fonnat Once the 
application is packaged, the process of assembling an 
application Is completed. 

15 [0034] In general, even after an application is pack- 
aged, modules may be added or removed before the 
application is deployed. Adding a module may include 
creating a new directory in the directory structure, or 
hierarchy, of the application to contain the new module. 

20 Alternatively, an application assembler may make a 
determination as to an appropriate location for a new 
module in the application package. Whether a new 
module is being added or an "old" modules is being 
removed, the deployment descriptors for the modules 

25 are edited to link internal dependencies for all current 
modules. In addition, the application deployment 
descriptor is typically also modified to identify the cur- 
rent modules. 

[0035] As described above with reference to Figure 

30 2, modules with deployment descriptors may either be 
stand-alone, e.g, independent, modules or part of an 
assembled application. With reference to Figure 5a, the 
steps associated with deploying a stand-alone module 
will be described in accordance with an embodiment of 

35 the present invention. The process of deploying a stand- 
alone module begins at step 504 in which a deployment 
tool, which may be part of a reference implementation, 
reads the deployment descriptor of the module. Once 
the deployment descriptor is read, then all components 

40 listed in the deployment descriptor at the module are 
deployed in step 508, In other words, the deployment 
tool deploys all components identified in the deployment 
descriptor based upon the deployment requirements of 
the appropriate component specification. By way of 

45 example, for an EJB module, the deployment tool may 
deploy all EJBs listed in the EJB module deployment 
descriptor according to a J2EE EJB component specifi- 
cation. When all listed components are deployed, then 
the process of deploying a stand-alone module Is com- 

50 pleted. 

[0036] Figure 5b is a process flow diagram which 
illustrates the steps associated with deploying an appli- 
cation which incorporates deployment descriptors, /.e., 
an application as packaged In step 420 of Rgure 4, in 
55 accordance with an embodiment of the present inven- 
tion. The process begins at step 524 in which a deploy- 
ment tool reads the application deployment descriptor 
of an application package. For an embodiment in which 
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the application is a J2EE application, the application 
deployment descriptor is read from the JAR which con- 
tains the application. 

[0037] A module listed in the application deploy- 
ment descriptor, e.g., the first listed module, is opened 
in step 528. Once the module is opened, then the 
deployment descriptor for the module is read in step 
532. Reading the deployment descriptor for the module 
enables all components described in the deployment 
descriptor to be identified. In step 536, all components 
described In the deployment descriptor are installed Into 
an appropriate container. The installation of the compo- 
nents is dependent, at least in part, upon the deploy- 
ment requirements of the associated component 
specification. By way of example, the Installation of an 
EJB component may differ from the installation of a web 
application component, as specified by their respective 
component specifications. 

[0038] After the components are installed in step 
536. the container in which the components are 
installed is configured in step 540 to reflect descriptions 
provided in the deployment descriptor for the module. In 
other words, the deployment tool configures the con- 
tainer to reflect the value of properties declared by the 
con-esponding element in the deployment descriptor for 
each component. 

[0039] From step 540, process flow moves to step 
544 in which a determination is made as to whether the 
application package includes additional modules. If the 
determination is that the application package does 
include additional modules, then process flow returns to 
step 528 where a subsequent module listed in the appli- 
cation deployment descriptor is opened. Alternatively, 
when it is determined that no additional modules are 
Included in the application package, /.e., when it is 
determined that all modules have been processed, then 
the process of deploying an application is completed. 
[0040] As previously mentioned, an application 
deployment descriptor generally Includes a listing of all 
modules included in an application. In some embodi- 
ments, the application deployment descriptor may addi- 
tionally include information such as a name and a 
description of the application. Figure 6 is a diagram- 
matic representation of an application deployment 
descriptor in accordance with an embodiment of the 
present invention. An application deployment descriptor 
602 may be a J2EE application deployment descriptor, 
i.e., application deployment descriptor way be defined 
by a J2EE:application document type definition. 
[0041] While the contents of application deploy- 
ment descriptor 602 may vary, as shown, application 
deployment descriptor 602 includes an icon entry 606, a 
display-name entry 610, an optional description entry 
614, at least one module entry 618, and a security-role 
entry 622. Icon entry 606, e.g., icon element 606. may 
be a universal record index (URI) which identifies a gif 
image or a jpeg image that represents the application 
with respect to a graphical user interface (GUI). Display- 



name entry 61 0 may be a name for the application. Typ- 
ically, the application name is assigned to the applica- 
tion by an assembler, and is arranged to identify the 
application to the deployer at deployment time. Optional 

5 description entry 614 provides substantially any infor- 
mation that an assembler believes would be of use to a 
deployer in a user-readable fomnat. 
[0042] Module entry 61 8, or element, is arranged to 
represent a module, and In the described embodiment, 

10 holds either an EJB, an application client module, or a 
web element. Module entry 618 is also arranged to 
specify an optional URI to the post assembly version of 
the associated deployment descriptor. As will be appre- 
ciated by those skilled in the art, application deployment 

75 descriptor 602 typically includes one module entry 618 
for each module in the overall application package. 
[0043] Security-role entry 622 generally contains a 
definition of a security role that is global with respect to 
the application. In one embodiment, security-role entry 

20 622 includes both a description of the security role, and 
an assigned name of the security role. Since there may 
be some inconsistency between security role names in 
application deployment descriptor 602 and at a compo- 
nent level, the names and descriptions in application 

25 deployment descriptor 602 typically override those at 
the component level. 

[0044] Figure 7 is a diagrammatic representation of 
an Enterprise Java Bean (EJB) module deployment 
descriptor in accordance with an embodiment of the 

30 present invention. An EJB deployment descriptor 702 
may have contents that vary depending, at least in part 
upon the requirements of a particular system. In the 
embodiment as shown. EJB deployment descriptor 702 
includes an icon entry 706, a display-name entry 710, 

35 an optional description entry 714, an assembly descrip- 
tor entry 718, and an enterprise beans entry 722. 
[0045] Icon entry 706, which may be referred to as 
an icon element, is similar to icon entry 606, as dis- 
cussed above with reference to Figure 6. That is, icon 

40 entry 706 may be a URI which identifies a gif image or a 
jpeg image that represents the EJB module that con-e- 
sponds to EJB deployment descriptor 702 with respect 
to a GUI. Display-name entry 710 is generally a name 
that is assigned to the EJB module by a developer, and 

45 is an^nged to identify the EJB module to a deployer at 
deployment rime. Optional description entry 714, when 
used, may provide information that a developer believes 
would be of use to a deployer in a user-readable format. 
[0046] Assembly descriptor entry 718 contains 

so Infomiation which is an-anged to facilitate the assembly 
of a EJB module into an application package. In one 
embodiment assembly descriptor entry 71 8 may include 
information that pertains to method pemiissions 726, 
container transactions 730, and security roles 734. 

55 Method permissions 726 typically relate to the manage- 
ment type of an entity EJB in temris of persistence. Con- 
tainer transactions 730, e.g., a container transaction 
element generally specifies how a container manages 
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transaction scopes for the method invocations of an 
EJB. In one embodiment, container transactions 730 
may include an optional description, a list of method ele- 
ments, and a transaction attribute. Security-roles 734, 
or a security role element, contains a definition of a 
security role with respect to the EJB module. Security- 
roles 734 may include both a description of the security 
role, and an assigned name of the security role. 
[0047] Enterprise beans entry 722, /.©., EJB ele- 
ment 722, includes an entity element 738 and a session 
element 742. Entity element 738 is arranged to declare 
an entity bean, e.g., a persistent bean. Although the 
declaration of an entity bean may include substantially 
any suitable infonnation, the declaration typically 
Includes the names of the home and remote interfaces 
of the entity bean, the implementation class of the entity 
bean, and the persistence management type of the 
entity bean. Session element 742 is arranged to declare 
a session bean, e.gr., a transient bean. In one embodi- 
ment, session clement 742 includes the names of the 
home and remote interfaces of the session bean, the 
state management type of the session bean, and the 
transaction management type of the session bean. 
[0048] Refen-ing next to Rgure 8, an example of a 
web client module deployment descriptor will be 
described- Figure 8 is a diagrammatic representation of 
a web client module deployment descriptor in accord- 
ance with an embodiment of the present invention. In 
the described embodiment, the contents of web client 
deployment descriptor 802 includes an icon entry 806, a 
display-name entry 810, an optional description entry 
814. an assembly descriptor 818, an exception page 
entry 822, and an en'or page entry 826. In addition, web 
client module deployment descriptor 802 also includes 
an environment entry 830, an EJB-reference entry 834, 
a resource-reference entry 838, a mime-mapping entry 
842, a Java server page (JSP) or servlet entry 846, and 
a welcome file entry 850. 

[0049] Icon entry 806 Identifies a gif image or a jpeg 
image that represents the application with respect to a 
GUI, while display-name entry 810 may be a name for 
the web client module. Optional description entry 814 
may be ranged to provide substantially any information 
that a module developer believes may be relevant to 
either or both an application assembler and a deployer 
In a user-readable format 

[0050] Assembly descriptor entry 818 includes a 
security-role element which identifies a security role 
with respect to the web client module. TTie security-role 
element may include both a description of the security 
role, and an assigned name of the security role. Excep- 
tion page entry 822 is arranged to contain the class 
name of an exception, e.g., an exception defined in the 
Java programming language. Error page entry 826 is 
arranged to contain a valid, numeric HTTP en'or-code. 
[0051] In one embodiment, environment entry 830 
contains a declaration of the environment associated 
with a web application. The declaration may include an 



optional description, the name of the environment entry, 
and an optional value. EJB-reference entry 834 is 
an^nged to be used forte declaration of reference to a 
home of an EJB. Resource-reference entry 838 speci- 
5 fies the name of a resource factory reference name, or 
the name of an environment entry of a web application 
whose value contains the JNDl name of the associated 
data source. 

[0052] Mime-mapping entry 842 contains a map- 

10 ping of a universal record locator (URL) pattern to a 
mime type, as will be appreciated by those skilled in the 
art. In the described embodiment, mime-mapping entry 
842 may include a specific URL, a directory of URLs, or 
a hierarchy of URLs. JSP or servlet entry 846 generally 

15 includes either declarative data for a JSP, e.g., a URI to 
a JSP file and the name of an initialization parameter, or 
declarative data of a servlet, e.g., a class name and a 
JAR element name. Welcome files entry 850 typically 
contains an ordered list of welcome files. 

20 [0053] Figure 9 is a diagrammatic representation of 
an application client module deployment descriptor in 
accordance with an embodiment of the present inven- 
tion. In general, the contents of application client 
deployment descriptor 902 includes an icon entry 906, a 

25 display-name entry 910, an optional description entry 
914, an environment-entry element 918, an EJB-refer- 
ence entry 922, and a resource reference entry 926. 
Icon element 906 identifies a gif image or a jpeg image 
that represents the application client module with 

30 respect to a GUI, while display-name entry 91 0 may be 
a name for the application client module. Optional 
description entry 914 typically provides infonnation that 
a module developer believes may be relevant to either 
or both an application assembler and a deployer. The 

35 information in optional description entry 914 is typically 
organized in a user-readable format. 
[0054] Environment-entry element 918, In one 
embodiment, contains a declaration of an environment 
entry for an application client module. Although the dec- 

40 laration may vary widely, the declaration often Includes 
an optional description, the name of the environment 
entry, and an optional value for the environment entry. 
EJB-reference entry 922 is typically used to declare a 
reference to the home of an EJB. Such a declaration 

45 may include, but is not limited to, an optional descrip- 
tion, a reference name for the EJB, an expected type for 
the referenced EJB, expected home and remote inter- 
faces, and EJB-link infonnation. Resource-reference 
entry 926 contains a declaration of a reference to an 

50 external resource of an application client module. The 
declaration, in the described embodiment, includes an 
optional description, a resource reference name, and an 
indication of the data source type of the resource that is 
expected. 

55 [0055] Figure 10 illustrates a typical, general-pur- 
pose computer system suitable for implementing the 
present invention. A computer system 1030 includes 
any number of processors 1 032 (also referred to as cen- 
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tral processing units, or CPUs) that are coupled to 
memory devices including primary storage devices 
1 034 (typically a random access memory, or RAM) and 
primary storage devices 1036 (typically a read only 
memory, or ROM). 

[0056] Computer system 1 030 or, more specifically, 
CPU 1032, may be arranged to support a virtual 
machine, as will be appreciated by those skilled in the 
art. One example of a virtual machine that is supported 
on computer system 1030 is a Java virtual machine 
(JVM). As is well known in the art, ROM acts to transfer 
data and instructions uni-di recti on ally to the CPU 1032, 
while RAM is used typically to transfer data and instruc- 
tions in a bi-directional manner. CPU 1032 may gener- 
ally include any number of processors. Both primary 
storage devices 1034, 1036 may include any suitable 
computer-readable media. A secondary storage 
medium 1 038, which is typically a mass memory device, 
is also coupled bi-directionally to CPU 1032 and pro- 
vides additional data storage capacity. The mass mem- 
ory device 1038 is a computer-readable medium that 
may be used to store programs including computer 
code, data, and the like. Typically, mass memory device 
1 038 is a storage medium such as a hard disk or a tape 
which is generally slower than primary storage devices 
1034, 1036. Mass memory storage device 1038 may 
take the form of a magnetic or paper tape reader or 
some other well-known device. It will be appreciated 
that the information retained within the mass memory 
device 1 038, may, in appropriate cases, be incorporated 
in standard fashion as part of RAM 1036 as virtual 
memory. A specific primary storage device 1034 such 
as a CD-ROM may also pass data uni-directionally to 
the CPU 1032. 

[0057] CPU 1032 is also coupled to one or more 
input/output devices 1 040 that may include, but are not 
limited to, devices such as video monitors, track balls, 
mice, keyboards, microphones, touch-sensitive dis- 
plays, transducer card readers, magnetic or paper tape 
readers, tablets, styluses, voice or handwriting recog- 
nizers, or other well-known input devices such as, of 
course, other computers. Finally, CPU 1032 optionally 
may be coupled to a computer or telecommunications 
network, e.g., a local area network, an internet network 
or an intranet network, using a network connection as 
shown generally at 1012. With such a network connec- 
tion, it is contemplated that the CPU 1 032 might receive 
infonnation from the network, or might output informa- 
tion to the network in the course of performing the 
above-described method steps. Such information, 
which is often represented as a sequence of instruc- 
tions to be executed using CPU 1032, may be received 
from and outputted to the network, for example, in the 
form of a computer data signal embodied in a carrier 
wave. The above-described devices and materials will 
be familiar to those of skill in the computer hardware 
and software arts. 

[0058] Although only a few embodiments of the 



present Invention have been described, it should be 
understood that the present invention may be embodied 
in many other specific forms without departing from the 
spirit or the scope of the invention. By way of example, 

5 steps involved with assembling an application which 
uses deployment descriptors may be reordered, 
removed or added. In general, steps involved with the 
methods of the present invention may be reordered, 
removed, or added without departing from the spirit or 

10 the scope of the present invention. 

[0059] In general, the contents of a deployment 
descriptor may vary. By way of example, although 
deployment descriptors have been described as not 
including attributes, e.g., XML attributes, in one embod- 

75 iment, deployment descriptors may include attributes. 
By not using attributes, however, the need to determine 
the difference between an entry, or element, in a deploy- 
ment descriptor and an attribute may effectively be elim- 
inated. 

20 [0060] While the present invention has been 
described in tenns of a J2EE platform, it should be 
appreciated that the present invention may be imple- 
mented on substantially any suitable platform. There- 
fore, the present examples are to be considered as 

25 illustrative and not restrictive, and the invention is not to 
be limited to the details given herein, but may be modi- 
fied within the scope of the appended claims. 

Claims 

30 

1. A method for deploying an application for use on a 
platform server, the application being deployed by a 
deployment tool, the method comprising: 

35 creating the application, wherein creating the 

application includes obtaining at least one 
application component, the application compo- 
nent having an associated application compo- 
nent deployment descriptor, the application 

40 component deployment descriptor including 

information relating to the deployment of the 
application component; 

creating an application deployment descriptor 
for the application, the application deployment 

45 descriptor including information arranged to 

identity the application component; 
packaging the application in an archive, the 
archive including the application component, 
the application component deployment 

50 descriptor, and the application deployment 

descriptor; and 

deploying the application packaged in the 
archive, wherein the application packaged in 
the archive is deployed using the application 
55 component deployment descriptor. 

2. A method for deploying an application as recited in 
claim 1 wherein creating the application further 
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includes obtaining a second application conaponent 
having an associated application component 
deployment descriptor. 

3. A method for deploying an application as recited in 5 
claim 2 wherein the application deployment 
descriptor includes information arranged to identify 
the second application component, and the archive 
further Includes the second application component 
and the application component descriptor associ- io 
ated with the second application component. 

4. A method for deploying an application as recited in 
one of claims 2 and 3 wherein deploying the appli- 
cation packaged in the archive further includes is 
using the application component deployment 
descriptor associated with the second application 
component deployment descriptor. 

5. A method for deploying an application as recited in 20 
any one of the preceding claims wherein the appli- 
cation is an enterprise application, and the applica- 
tion component is one selected from the group 
consisting of an enterprise bean and a web applica- 
tion. 25 

6. A computer program product for deploying an appli- 
cation for use on a platform server, the application 
being deployed by a deployment tool, the computer 
program product comprising: 30 



7. A computer program product for deploying an appli- 
cation as recited in claim 6 wherein the computer 
code for creating the application further includes 
computer code for obtaining a second application 
component having an associated application com- 
ponent deployment descriptor. 

8. A computer program product for deploying an appli- 
cation as recited in claim 7 wherein the application 
deployment descriptor includes information 
arranged to identify the second application compo- 
nent, and the archive further includes the second 
application component and the application compo- 
nent descriptor associated with the second applica- 
tion component 

9. A computer program product for deploying an appli- 
cation as recited In one of claims 7 arid 8 wherein 
the computer code for deploying the application 
packaged in the archive further includes computer 
code for using the application component deploy- 
ment descriptor associated with the second appli- 
cation component deployment descriptor. 

10. A computer program product for deploying an appli- 
cation as recited in any one of claims 6-9 wherein 
the application is an enterprise application, and the 
application component is one selected from the 
group consisting of an enterprise bean and a web 
application. 



IS 



20 



computer code for creating the application, 
wherein the computer code for creating the 
application includes computer code for obtain- 
ing at least one application component, the 35 
application component having an associated 
application component deployment descriptor, 
the application component deployment 
descriptor including infomriation relating to the 
deployment of the application component; 40 
computer code for creating an application 
deployment descriptor for the application, the 
apprtcation deployment descriptor including 
information arranged to identify the application 
component; 45 
computer code for packaging the application in 
an archive, the archive including the application 
component, the application component deploy- 
ment descriptor, and the application deploy- 
ment descriptor, 

computer code for deploying the application 
packaged in the archive, wherein the applica- 
tion packaged in the archive is deployed using 
the application component deployment 
descriptor; and 55 
a computer readable medium that stores the 
computer codes. 



11. An archival data structure for use with an applica- 
tion, the application being suitable for deployment 
on a computer system, the data structure compris- 
ing: 

an application component; 
an application deployment descriptor, the appli- 
cation deployment descriptor including infor- 
mation annnged to identify the application 
component; and 

an application component deployment descrip- 
tor, the application component deployment 
descriptor including information relating to the 
deployment of the application component, 
wherein the application component is arranged 
to be deployed using the application compo- 
nent deployment descriptor. 



a second application component; and 
a second application component descriptor 
associated with the second application compo- 
nent. 

13. An archival data structure according to claim 12 



50 1 2. An archival data structure according to claim 1 1 fur- 
ther including: 
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wherein the application deployment descriptor is 
further aoBnged to Identity the second application 
component. 

14. An archival data structure according to claim 13 
wherein the application deployment descriptor Is 
still further arranged to specify an interaction 
between the application component and the second 
application component. 
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